home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / lastc_11.arc / LASTCALL.DOC next >
Text File  |  1991-09-29  |  12KB  |  457 lines
  1.                                   27-SEP-1991
  2.  
  3.  
  4.  
  5.                              LastCall Version 1.10
  6.                                          
  7.                       A BINKLEY.CLD File Analysis Utility
  8.                            Author: Steven K. Shapiro
  9.                                          
  10.                               SysOp LoneStar CBCS
  11.                                 FidoNet 1:382/35
  12.                                  (512) 258-3643
  13.                                          
  14.                            Program and Documentation
  15.                 Copyright (C) 1991 SKS Computer Consulting, Inc.
  16.                               All Rights Reserved
  17.                                          
  18.                                          
  19.                                          
  20.                     LastCall IS NOT PUBLIC DOMAIN SOFTWARE!
  21.                                          
  22.                        LastCall IS COPYRIGHTED SOFTWARE.
  23.                                          
  24.                    YOU ARE ENTITLED TO USE AND DISTRIBUTE THE
  25.               LASTCALL PACKAGE ONLY IN ACCORDANCE WITH THE LICENSE
  26.                           AGREEMENT CONTAINED HEREIN.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                   27-SEP-1991
  67.  
  68.  
  69.  
  70.      LICENSE AGREEMENT, WARRANTY AND STATEMENT OF LIABILITY 
  71.  
  72.      The  term  "the  package"  refers  to  the   LastCall   software   and
  73.      documentation,  individually  and collectively.  The term "the author"
  74.      shall be construed to mean Steven K.  Shapiro.  
  75.  
  76.      The package is the exclusive property of the author, and is  protected
  77.      by  copyright  laws.   By  obtaining a copy of the package, you do not
  78.      "own" a copy...all property rights are retained by  the  author.   You
  79.      are merely licensed to USE it.  
  80.  
  81.      This  License  grants limited rights to use and distribute the package
  82.      in accordance with the terms listed herein.  Any other use constitutes
  83.      a violation of the author's rights under United States Copyright  Law,
  84.      and applicable treaties.  
  85.  
  86.      You  may  use the package and/or give copies of the package to others,
  87.      but only in a form that permits inclusion of all files as found in the
  88.      original, archived form in which the package  is  distributed  by  the
  89.      author.  You are not permitted to modify any portion of the package in
  90.      any  way,  including,  but  not limited to adding files to or removing
  91.      files   from   the  distribution  package,  changing  or  editing  the
  92.      documentation,   and/or   changing   or   modifying   the   executable
  93.      program(s).  
  94.  
  95.      If you find the package to  be  of  use,  and  feel  that  a  monetary
  96.      contribution  is  in  order,  you  are encouraged to forward it to the
  97.      author.  
  98.  
  99.      The package is not provided with any warranty of any kind,  including,
  100.      but not limited to fitness for any particular purpose.  
  101.  
  102.      IMPORTANT NOTE:  If this License or any portion thereof is not legally
  103.      valid  in  your  geographical  area  or  jurisdiction, THIS LICENSE IS
  104.      WITHDRAWN and YOU ARE NOT LICENSED TO USE OR DISTRIBUTE THE PACKAGE!  
  105.  
  106.      WARNING!  YOU USE THIS PACKAGE ENTIRELY AT YOUR OWN RISK!  The  author
  107.      will  NOT  be responsible for any loss of data, loss of business, loss
  108.      of monies or any other damages resulting from the use of, or inability
  109.      to use this  program.   By  operating  the  program,  you  accept  and
  110.      acknowledge responsibility IN FULL for all occurrences related to your
  111.      use  of  the  program.   In  any jurisdiction where such limitation of
  112.      liability is restricted or forbidden, this program IS NOT licensed for
  113.      legal use.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                        2
  131.                                   27-SEP-1991
  132.  
  133.  
  134.  
  135.      OTHER USES (NON-LICENSED USES) 
  136.  
  137.      Use and distribution outside the scope of the License Agreement  above
  138.      is  strictly  prohibited, unless prior, written permission is obtained
  139.      from  the  author.   Inquiries  may  be  directed  to:   SKS  Computer
  140.      Consulting, Inc., P.O.  Box 202350, Austin, TX, 78720, USA.  Include a
  141.      self-addressed, stamped envelope for replies.  
  142.  
  143.      DISTRIBUTION NOTICE 
  144.  
  145.      The  package  may  be  posted for download or file request by any FTSC
  146.      compliant system in archived form, and in adherence to  the  terms  of
  147.      the  License  above.  No profit may be realized directly or indirectly
  148.      from such distribution, although  the  package  may  be  provided  for
  149.      download on 'pay systems'.  
  150.  
  151.      ARCHIVES 
  152.  
  153.      The  regular  distribution  version  of  the package is archived using
  154.      PKZIP from PKWare, Inc.  This is NOT a  political  statement,  it's  a
  155.      matter of personal preference.  
  156.  
  157.      If  you  feel it necessary to re-archive the package in a format other
  158.      than the format it's delivered in, go ahead, but you should  read  the
  159.      License Agreement carefully.  Any distribution of the package requires
  160.      that ALL the files AS ORIGINALLY DISTRIBUTED must be included.  
  161.  
  162.      Prior  to  distribution,  make  certain that you have a full, original
  163.      version, and make sure all the files in the package make it into  your
  164.      new archive.  Addition of files to the distribution is prohibited.  
  165.  
  166.      PURCHASING COPIES OF THE PACKAGE 
  167.  
  168.      The  package  is also available on diskette within the USA and Canada.
  169.      Send check or money order in US dollars to:  SKS Computer  Consulting,
  170.      Inc., P.O.  Box 202350, Austin, TX, 78720, USA.  
  171.  
  172.      SOURCE CODE 
  173.  
  174.      Source  code to the package will not be available.  I do not feel that
  175.      I need to justify my reasoning.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                        3
  196.                                   27-SEP-1991
  197.  
  198.  
  199.  
  200.      PROGRAM OPERATION 
  201.  
  202.      LastCall provides the user the ability to  compare  the  values  in  a
  203.      BINKLEY.SCD  file  with  those  specified  as  input  arguments to the
  204.      LastCall program.  
  205.  
  206.      This program was developed because the data structures were changed in
  207.      BinkleyTerm 2.50 from those in the previous version.  As such, I could
  208.      no longer use the utility which I had been using.   Unfortunately  the
  209.      author of that utility had disappeared so I was left without a program
  210.      like this.  
  211.  
  212.      The initial release only provides the user with the ability to compare
  213.      the Network address against the BINKLEY.SCD file.  Future versions may
  214.      allow additional fields to be compared.  
  215.  
  216.      The format for using LastCall is:  
  217.  
  218.      
  219.      LASTCALL /I<input file>
  220.               /C<config file>
  221.               /A<address>
  222.               /E<errorlevel>
  223.  
  224.      Where  all arguments are entered on the same line interactively or via
  225.      a batch file.  The arguments may occur in any order and all should  be
  226.      entered  unless  otherwise  indicated.   Failure  to  enter any or all
  227.      command line arguments will result in undesired results.  
  228.  
  229.      /I<Input_file> 
  230.  
  231.      Optional.  
  232.  
  233.      This is the filename of the BINKLEY.SCD file from which to extract the
  234.      information.  If you specify this information, LastCall will expect to
  235.      find the file specified.  If it is  not  found,  or  if  you  fail  to
  236.      specify  a fully qualified DOS filename you're out of luck as LastCall
  237.      will not search anywhere else for the file.  
  238.  
  239.      If you do not specify an input file, LastCall  will  first  check  the
  240.      current  directory  for  the  file:   BINKLEY.SCD  and if it finds it,
  241.      LastCall will use it as the input file.  If LastCall does not find the
  242.      file in the current directory, it will attempt to decode  the  BINKLEY
  243.      environment  variable.   If  this  variable has not been set, LastCall
  244.      will abort.  If this variable has been set, LastCall  will  check  for
  245.      the  existance  of  a  BINKLEY.SCD  file in the path pointed to by the
  246.      environment variable.  If LastCall finds the file, it will use  it  as
  247.      the input file.  If it does not find the file, LastCall will abort.  
  248.  
  249.      /C<config_file> 
  250.  
  251.      Optional.  
  252.  
  253.      This  file  could be used as an alternative to the command line method
  254.      of running LastCall.  Instead of specifying  the  target  address  and
  255.      errorlevel  via  the  /A and /E command line switches, the information
  256.  
  257.  
  258.  
  259.  
  260.                                        4
  261.                                   27-SEP-1991
  262.  
  263.  
  264.  
  265.      could be placed into a configuration file.  
  266.  
  267.      The advantage to this method is that 1).   it  provides  compatibility
  268.      with  the  method used by Lastnode and 2).  it allows you to specify a
  269.      list of nodes with their associated errorlevels.  If  this  switch  is
  270.      specified,  it  will  supercede any values which may be specified with
  271.      the /A or /E switches.  
  272.  
  273.      Example:  LASTCALL /Cconfig.dat 
  274.  
  275.      Where config.dat could contain the information in the form:  
  276.  
  277.      
  278.           1:382/3000  124
  279.           1:382/35    123
  280.           1:382/1     125
  281.  
  282.      When LastCall runs under this scenario, if the  last  call  came  from
  283.      node  1:382/3000,  the  errorlevel to be returned would be 124, if the
  284.      last call came from node 1:382/35, the errorlevel to be returned would
  285.      be 123, etc.  
  286.  
  287.      /A<address> 
  288.  
  289.      Required if not using the /C option.  
  290.  
  291.      This is the network node address you which  to  check  against.   This
  292.      node number must be a fully qualified '3D' string of the form:  
  293.  
  294.      zone:net/node 
  295.  
  296.      If  you  fail to specify the node number properly the program will not
  297.      find a match and you will be out of luck.  
  298.  
  299.      /E<errorlevel> 
  300.  
  301.      Required if not using the /C option.  
  302.  
  303.      This is the errorlevel which the program  should  use  when  it  exits
  304.      under a success condition.  
  305.  
  306.      When  the  LastCall  comparison is UNSUCCESSFUL, an errorlevel of 0 is
  307.      returned.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                        5
  326.                                   27-SEP-1991
  327.  
  328.  
  329.  
  330.      EXAMPLES:  
  331.  
  332.      1).  LASTCALL /ibinkley.scd /a1:382/35 /e123 
  333.  
  334.      LASTCALL would analyse the file binkley.scd in the  current  directory
  335.      to  see  if  the  last  node which called was 1:382/35.  If it was, an
  336.      errorlevel of 123 is returned, if it wasn't, an errorlevel  of  9  was
  337.      returned.  
  338.  
  339.      2).  LASTCALL /ic:\binkley\binkley.scd /e543 /a1:382/35 
  340.  
  341.      LASTCALL  would  analyse  the  file  binkley.scd  in   the   directory
  342.      c:\binkley  to  see if the last node which called was 1:382/35.  If it
  343.      was, an errorlevel of 543 is returned, if it wasn't, an errorlevel  of
  344.      9 was returned.  
  345.  
  346.      That's  pretty  much it.  If you have questions or comments, feel free
  347.      to contact me via my BBS as listed above.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                        6
  391.                                   27-SEP-1991
  392.  
  393.  
  394.  
  395.      HISTORY 
  396.  
  397.      v1.00 09/25/1991 
  398.  
  399.      This is the initial release of LastCall.  
  400.  
  401.  
  402.      v1.10 09/28/1991 
  403.  
  404.      1.   Added functionality to support the optional  entry  of  an  input
  405.           schedule  file  as  well  as  a  check  for the file in the local
  406.           directory or via the BINKLEY environment variable.  
  407.  
  408.      2.   Added support for the /C config file implementation.  
  409.  
  410.           
  411.  
  412.           
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.                                        7
  456.  
  457.